.TH E1432_SET_SINE_PHASE 3 E1432
.SH NAME
.nf
e1432_set_sine_phase \- Set source sine start phase of E1432 channels
e1432_get_sine_phase \- Get source sine start phase of E1432 channels
.fi
.IX e1432_set_sine_phase(3) 3
.IX e1432_get_sine_phase(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_sine_phase(E1432ID hw, SHORTSIZ16 ID,
                               FLOATSIZ32 sine_phase)
SHORTSIZ16 e1432_get_sine_phase(E1432ID hw, SHORTSIZ16 ID,
                               FLOATSIZ32 *sine_phase)
.cE
.SH DESCRIPTION

\fIe1432_set_sine_phase\fR sets the source sine start phase, of a
single channel or group of channels \fIID\fR, to the value given in
\fIsine_phase\fR.  When the source is in sinewave generation mode,
this is the starting phase of the sinewave that is generated.

\fIe1432_get_sine_phase\fR returns the value of the source sine phase,
of a single channel or group of channels \fIID\fR, into a memory
location pointed to by \fIsine_phase\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.

\fIsine_phase\fR is the starting sine phase in degrees.  It must be
between -360 and 360 degress.  The sinusoid signal is expressed
as sin(sine_freq*t + sine_phase).  If sine_phase is changed during
a measurement, the phase is incremented by the difference between
sine_phase and the previous value of sine_phase.  Note: sine_phase 
cannot be changed during a measurement when using the burst sine
mode (\fBE1432_SOURCE_MODE_BSINE\fR) of operation.  

For input channels, sine phase is not used.

For source channels, the sine phase is used when in sinewave mode.

For tach channels, sine phase is not used.
.SH "RESET VALUE"
After a reset, the \fIsine_phase\fR is set to zero.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_sine_freq, e1432_get_sine_phase_limits
.ad
